
<html><HEAD>
<LINK REL=STYLESHEET HREF="default.css" TYPE="text/css">
<TITLE>
Setting properties for the TreeView DataWindow</TITLE>
</HEAD>
<BODY>

<!-- Header -->
<p class="ancestor" align="right"><A HREF="pbugp242.htm">Previous</A>&nbsp;&nbsp;<A HREF="pbugp244.htm" >Next</A>
<!-- End Header -->
<A NAME="BABGGBHA"></A><h1>Setting properties for the TreeView DataWindow</h1>
<A NAME="TI8352"></A><p>You can set three types of properties for the TreeView DataWindow:<A NAME="TI8353"></A>
<ul>
<li class=fi>General
properties</li>
<li class=ds>TreeView level properties</li>
<li class=ds>Detail band properties
</li>
</ul>
</p>
<A NAME="TI8354"></A><h4>Specifying images for tree node icons</h4>
<A NAME="TI8355"></A><p>In the sample DataWindow shown in <A HREF="pbugp238.htm#BABEJEJC">"Creating a new TreeView DataWindow"</A>, different tree node icons display
for collapsed and expanded levels. The icons are also different
for each level. You specify images for these icons as TreeView level
band properties.</p>
<A NAME="TI8356"></A><p>The sample DataWindow also displays a tree node icon next
to every row in the detail band. You specify an image for this icon
as a detail band property.</p>
<A NAME="TI8357"></A><p>Tree node icons do not display by default. After specifying
images for icons, select the Use Tree Node Icon general property.</p>
<A NAME="BABCFIHD"></A><h2>Setting general TreeView properties</h2>
<A NAME="TI8358"></A><p>You set most TreeView DataWindow properties on the General page in
the Properties view for the DataWindow object. </p>
<br><img src="images/dwprops.gif">
<A NAME="TI8359"></A><p>The properties that are specific to a TreeView DataWindow are
the TreeView properties and the Grid properties. The grid-related
properties display only if you select the Grid Style check box when
you define the TreeView DataWindow.</p>
<A NAME="TI8360"></A><table cellspacing=0 cellpadding=6 border=1 frame="void" rules="all"><tr><th  rowspan="1"  ><A NAME="TI8361"></A>Property</th>
<th  rowspan="1"  ><A NAME="TI8362"></A>Description</th>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI8363"></A>Display</td>
<td  rowspan="1"  ><A NAME="TI8364"></A><i>On</i> &#8211; Grid
lines always display.<A NAME="TI8365"></A><p><i>Off</i> &#8211; Grid lines never display
(columns cannot be resized at runtime).</p><A NAME="TI8366"></A><p><i>Display Only</i> &#8211; Grid lines display
only when the DataWindow object displays online.</p><A NAME="TI8367"></A><p><i>Print Only</i> &#8211; Grid lines display
only when the contents of the DataWindow object are printed.</p></td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI8368"></A>Column Moving</td>
<td  rowspan="1"  ><A NAME="TI8369"></A>Columns can be moved at runtime.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI8370"></A>Mouse Selection</td>
<td  rowspan="1"  ><A NAME="TI8371"></A>Data can be selected at runtime and,
for example, copied to the clipboard.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI8372"></A>Row Resize</td>
<td  rowspan="1"  ><A NAME="TI8373"></A>Rows can be resized at runtime.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI8374"></A>Indent Value</td>
<td  rowspan="1"  ><A NAME="TI8375"></A>The indent value of the child node from
its parent in the units specified for the DataWindow. The indent value
defines the position of the state icon. The X position of the state
icon is the X position of its parent plus the indent value.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI8376"></A>Expand To Level By Default</td>
<td  rowspan="1"  ><A NAME="TI8377"></A>Expand to TreeView level 1, 2, or 3.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI8378"></A>State Icon Align Mode</td>
<td  rowspan="1"  ><A NAME="TI8379"></A>Align the state icon in the middle (0),
at the top (1), or at the bottom (2).</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI8380"></A>Show Lines</td>
<td  rowspan="1"  ><A NAME="TI8381"></A>Whether lines display that connect parent
nodes and child nodes. If you want to display lines that connect the
rows in the detail band to their parent, select Connect Leaf Nodes.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI8382"></A>Connect Leaf Nodes</td>
<td  rowspan="1"  ><A NAME="TI8383"></A>Whether lines display that connect the
leaf nodes in the detail band rows.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI8384"></A>Use Tree Node Icon</td>
<td  rowspan="1"  ><A NAME="TI8385"></A>Whether an icon for the tree node displays.
This applies to icons in the level and detail bands. For how to
specify icon images, see <A HREF="pbugp243.htm#BABBBBGG">"Setting TreeView level properties"</A> and <A HREF="pbugp243.htm#BABFFIBJ">"Setting detail band properties"</A>.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI8386"></A>Select Node By Mouse</td>
<td  rowspan="1"  ><A NAME="TI8387"></A>Whether a Tree node is selected by clicking
the Tree node with the mouse. </td>
</tr>
</table>
<A NAME="BABBBBGG"></A><h2>Setting TreeView level properties</h2>
<A NAME="TI8388"></A><p>In the Properties view for a band, you can specify expanded
and collapsed icons for each TreeView level. You access the Properties view by
clicking the bar identifying the band for that level in the Design
view in the DataWindow painter. You can also access the Properties view from
the Rows menu, or by clicking any of the icons in the Design view
that represent the locations of nodes, icons, and connecting lines.
(See <A HREF="pbugp242.htm#BABGHABH">"Icons in the Design view"</A>.)</p>
<A NAME="TI8389"></A><p><img src="images/proc.gif" width=17 height=17 border=0 align="bottom" alt="Steps"> To modify properties for a level in a TreeView DataWindow:</p>
<ol><li class=fi><p>Select Rows&gt;Edit TreeView Level from
the menu bar and then select the number of the level from the list
of levels, or click the bar identifying the band for that level
or any of the icons in that band.</p></li>
<li class=ds><p>Use the DataWindow TreeView Level properties view
that displays to edit the properties for the level you selected.</p><br><img src="images/detailgp.gif"><br>
</li></ol>
<br><A NAME="TI8390"></A><p>The properties that are specific to a TreeView level band
are at the bottom of the Properties view:</p>
<A NAME="TI8391"></A><table cellspacing=0 cellpadding=6 border=1 frame="void" rules="all"><tr><th  rowspan="1"  ><A NAME="TI8392"></A>Property</th>
<th  rowspan="1"  ><A NAME="TI8393"></A>Description</th>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI8394"></A>Tree Node Icon File</td>
<td  rowspan="1"  ><A NAME="TI8395"></A>The file name of the tree node icon in
a TreeView level band when it is in the expanded state.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI8396"></A>Collapsed Tree Node Icon File</td>
<td  rowspan="1"  ><A NAME="TI8397"></A>The file name of the tree node icon in
a TreeView level band when it is in the collapsed state.</td>
</tr>
</table>
<A NAME="TI8398"></A><p>You set the tree node icon file name separately for each TreeView
level band. You can use a quoted expression for the tree node icon
file.</p>
<A NAME="BABFFIBJ"></A><h2>Setting detail band properties</h2>
<A NAME="TI8399"></A><p>You can specify an icon for the rows in the detail band by
clicking the detail band in the DataWindow painter to display the Properties view.</p>
<br><img src="images/detailbd.gif">
<A NAME="TI8400"></A><p>If you want to hide tree nodes in the detail band, set the
Height property to 0. The only property that is specific to the
TreeView DataWindow is located at the bottom of the Properties view:</p>
<A NAME="TI8401"></A><table cellspacing=0 cellpadding=6 border=1 frame="void" rules="all"><tr><th  rowspan="1"  ><A NAME="TI8402"></A>Property</th>
<th  rowspan="1"  ><A NAME="TI8403"></A>Description</th>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI8404"></A>Tree Node Icon File</td>
<td  rowspan="1"  ><A NAME="TI8405"></A>The file name of the tree node icon in
the detail band. You can use a quoted expression.</td>
</tr>
</table>
<A NAME="TI8406"></A><h4>For more information</h4>
<A NAME="TI8407"></A><p>For reference information about TreeView DataWindow properties,
methods and events, see the <i>DataWindow Reference</i>
 or
the online Help.</p>

